<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html> 
<head>
<TITLE>Global Assembly Cache Tool (gacutil.exe)</TITLE>
<link rel="stylesheet" type="text/css" href="../rotor.css">
</head>
<body>
<H1>Global Assembly Cache Tool (gacutil.exe)</H1>

<P>The Global Assembly Cache tool allows you to view and manipulate the contents 
of the global assembly cache.  </P>

<P>This application file is named gacutil.exe on a Shared Source 
CLI (SSCLI) 
built on Microsoft Windows&reg;.</P>

<P> Note: the  SSCLI implementation of the gacutil tool does not 
support code download or precompiled JIT.
</P>

<P> The following options of the gacutil tool supported on the Microsoft&reg; .NET Framework 
implementation were removed from the SSCLI:</P>

<ul>
  <li><b>/cdl</b>&nbsp;&nbsp;&nbsp;&nbsp;<ul>
  <li>Deletes the contents of the download cache.</li>
</ul>

  </li>
  <li><b>/help</b>&nbsp;&nbsp;

<ul>
  <li>Sends usage output to the console.&nbsp; Use <b>/?</b> instead.</li>
</ul>

  </li>
  <li><b>/if </b>&nbsp;&nbsp;&nbsp;&nbsp;<ul>
  <li>Installs an assembly to the global assembly cache and forces 
overwrite if the assembly already exists in cache. </li>
</ul>

  </li>
  <li><b>/ir</b>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<ul>
  <li>Installs an assembly to the global assembly cache with traced 
reference. </li>
</ul>

  </li>
  <li><b>/ldl</b>&nbsp;&nbsp;&nbsp;&nbsp;<ul>
  <li>Lists the contents of the downloaded files cache.</li>
</ul>

  </li>
  <li><b>/lr</b>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<ul>
  <li>Lists the contents of 
  the global assembly cache with traced reference information.</li>
</ul>

  </li>
  <li><b>/ungen</b>&nbsp;

<ul>
  <li>If ngen is specified, the assembly is removed from the 
  cache of native image files.</li>
</ul>

  </li>
</ul>

<p>The following options are supported by the SSCLI implementation of the Global 
Assembly Cache tool.</p>

<h4>Usage</h4>

<blockquote>

<PRE class="syntax"><B>gacutil</B> [<I>options</I>] [<I>assembly</I>]</PRE>
</blockquote>

<table border=1 width="90%">

<TR VALIGN="top">
<TH width=25%>Argument</TH>
<TH width=75%>Description</TH>
</TR>

<TR VALIGN="top">
<TD width=25%><I>assembly</I></TD>
<TD width=75%>The name of a file that contains an assembly manifest.</TD>
</TR>
</table>

<h4> Options</h4>

<P> Options can be specified using either a dash (-) or a slash 
(/). 
</P>

<table border=1 width="90%">
<TR VALIGN="top">
<TH width=25%>Option</TH>
<TH width=75%>Description</TH>
</TR>

<TR VALIGN="top">
<TD width=25%><B>/i</B> <I>assembly</I></TD>
<TD width=75%>Installs an assembly into the global assembly cache.  </TD>
</TR>

<TR VALIGN="top">
<TD width=25%><B>/l</B></TD>
<TD width=75%>Lists the contents of the global assembly cache.</TD>
</TR>

<TR VALIGN="top">
<TD width=25%><B>/nologo</B></TD>
<TD width=75%>Suppresses the Microsoft startup banner display.</TD>
</TR>

<TR VALIGN="top">
<TD width=25%><B>/silent</B></TD>
<TD width=75%>Suppresses the display of all output.</TD>
</TR>

<TR VALIGN="top">
<TD width=25%><B>/u</B> <I>assemblyfile</I></TD>
<TD width=75%>Uninstalls a specified assembly,<i> assemblyfile,</i> from the global assembly cache. 
</TD>
</TR>

<TR VALIGN="top">
<TD width=25%><B>/?</B></TD>
<TD width=75%>Displays command syntax and options for the tool.</TD>
</TR>
</table>

<H4>Remarks</H4>

<P>The Global Assembly Cache allows you to install assemblies into the cache, remove them from the cache, and list the contents of the cache. </P>

<H4>Examples</H4>

<P>The following command inserts the file <CODE>mydll.dll</CODE> into the global assembly cache.</P>

<PRE>gacutil /i mydll.dll</PRE>

<P>The following command removes the assembly <CODE>hello</CODE> from the global assembly cache.</P>

<PRE>gacutil /u hello</PRE>

<P>Note that the prior command might remove more than one assembly from the assembly cache because the assembly name is not fully specified.  For example, if both version 1.0.0.0 and 3.2.2.1 of <CODE>hello</CODE> are installed in the cache, the command <CODE>gacutil /u hello</CODE> removes both of the assemblies.</P>

<P>Use the following example to avoid removing more than one assembly. This command removes only the <CODE>hello</CODE> assembly that matches the fully specified version number, culture, and public key.</P>

<PRE>gacutil /u hello,
Version=1.0.0.1,Culture="de",PublicKeyToken=45e343aae32233ca</PRE>

<P>The following command lists the contents of the global assembly cache.</P>

<PRE>gacutil /l</PRE>

<h5>See Also</h5>

<P><a href="Tools_Index.html">Tools Index</a></P>
<hr>
<p><i>Copyright (c) 2006 Microsoft Corporation. All rights reserved.</i></p>
</BODY>
</HTML>